\section{Area.mui}

Area class is a super class for every other MUI class
except windows and applications. It holds information
about an objects current position, size and weight
and manages frames, fonts and backgrounds.

Additionally, area class handles the user input. By
setting an objects MUIA\_InputMode, you can make it
behave like a button or like a toggle gadget. That's
why MUI doesn't offer an extra button class. A button
is simply a text object with a raised frame and a relverify
input mode. Since especially group class is a subclass
of area, you can create rather complex buttons consisting
of many other display elements.

\subsection[MUIM\_AskMinMax]{MUIM\_AskMinMax (V4)}
[For use within custom classes only]

\subsubsection*{SYNOPSIS}
DoMethod(obj,MUIM\_AskMinMax,struct MUI\_MinMax *MinMaxInfo);

\subsubsection*{FUNCTION}
see developer documentation.

\subsection[MUIM\_Cleanup]{MUIM\_Cleanup (V4)}
[For use within custom classes only]

\subsubsection*{SYNOPSIS}
DoMethod(obj,MUIM\_Cleanup,);

\subsubsection*{FUNCTION}
see developer documentation.

\subsection[MUIM\_Draw]{MUIM\_Draw (V4)}
[For use within custom classes only]

\subsubsection*{SYNOPSIS}
DoMethod(obj,MUIM\_Draw,ULONG flags);

\subsubsection*{FUNCTION}
see developer documentation.

\subsection[MUIM\_HandleInput]{MUIM\_HandleInput (V4)}
[For use within custom classes only]

\subsubsection*{SYNOPSIS}
DoMethod(obj,MUIM\_HandleInput,struct IntuiMessage *imsg, LONG muikey);

\subsubsection*{FUNCTION}
see developer documentation.

\subsection[MUIM\_Hide]{MUIM\_Hide (V4)}
[For use within custom classes only]

\subsubsection*{SYNOPSIS}
DoMethod(obj,MUIM\_Hide,);

\subsubsection*{FUNCTION}
see developer documentation.

\subsection[MUIM\_Setup]{MUIM\_Setup (V4)}
[For use within custom classes only]

\subsubsection*{SYNOPSIS}
DoMethod(obj,MUIM\_Setup,struct MUI\_RenderInfo *RenderInfo);

\subsubsection*{FUNCTION}
see developer documentation.

\subsection[MUIM\_Show]{MUIM\_Show (V4)}
[For use within custom classes only]

\subsubsection*{SYNOPSIS}
DoMethod(obj,MUIM\_Show,);

\subsubsection*{FUNCTION}
see developer documentation.

\subsection[MUIA\_ApplicationObject]{MUIA\_ApplicationObject -- (V4) [..G], Object *}

\subsubsection*{FUNCTION}
You can obtain a pointer to the application object
that some gadget belongs to by using this attribute.
Useful mainly within callback hooks if you do not want
to deal with global variables.

\subsubsection*{SEE ALSO}
MUIA\_WindowObject

\subsection[MUIA\_Background]{MUIA\_Background -- (V4) [IS.], LONG}

\subsubsection*{FUNCTION}
Adjust the background for an object.

Every MUI object has its own background setting.
The background is displayed ''behind'' the actual
object contents, e.g. behind a the text of a
text object or behind the image of an image object.

This attribute takes the same values as MUIA\_Image\_Spec,
please refer to autodocs of image class for a complete
description.

An object without a specific background setting will
inherit the pattern from its parent group. The default
background for a window and many other background
patterns are adjustable with the preferences program.

Only a few MUII\_xxxxxxx tags make sense as background.
Important are:

\begin{description}
\item[MUII\_ButtonBack:]
You have to set this when you create a button gadget.
Thus, your button will be displayed in the users
preferred style.

\item[MUII\_TextBack:]
Set this when you create a text object with a TextFrame,
e.g. some kind of status line. Do *not* use MUII\_TextBack
for simple text without frame (e.g. gadget labels).
\end{description}
   
\noindent \begin{tabular}{l}
MUII\_BACKGROUND\\
MUII\_SHADOW\\
MUII\_SHINE\\
MUII\_FILL\\
MUII\_SHADOWBACK\\
MUII\_SHADOWFILL\\
MUII\_SHADOWSHINE\\
MUII\_FILLBACK\\
MUII\_FILLSHINE\\
MUII\_SHINEBACK\\
MUII\_SHINEBACK2\\
\end{tabular}
   
One of MUI's predefined pattern. These are not
configurable by the user and will always look the
same.

\subsubsection*{NOTE}
It is {\bf important} that you test your programs with
a fancy pattern configuration. With the default
setting you won't notice any errors in your backgrounds.

\subsection[MUIA\_BottomEdge]{MUIA\_BottomEdge -- (V4) [..G], LONG}

\subsubsection*{FUNCTION}
You can use this to read the current position and
dimension of an object, if you e.g. need it to pop
up some requester below.

Of course, this attribute is only valid when the
parent window of the object is currently open.

\subsubsection*{SEE ALSO}
MUIA\_TopEdge, MUIA\_Width, MUIA\_Height,
MUIA\_RightEdge, MUIA\_LeftEdge

\subsection[MUIA\_ControlChar]{MUIA\_ControlChar -- (V4) [I..], char}

\subsubsection*{FUNCTION}
Pressing the control char will have the same effect
as pressing return if the object was active.

This can be used to create old style key shortcuts.

\subsubsection*{NOTE}
Using an uppercase control char will force
the user to press shift.

\subsubsection*{SEE ALSO}
mui.h / KeyButton() macro

\subsection[MUIA\_Disabled]{MUIA\_Disabled -- (V4) [ISG], BOOL}

\subsubsection*{FUNCTION}
Disable or enable a gadget. Setting this attribute
causes a gadget to become disabled, it gets a ghost
pattern and doesn't respond to user input any longer.

Disabled gadgets cannot be activated with the TAB key.

Using MUIA\_Disable on a group of objects will disable
all objects within that group.

\subsubsection*{EXAMPLE}
\small
\begin{verbatim}
/* we have a radio button gadget with three         */
/* entries, the third should enable a string gadget */
/* with additional parameters                       */

DoMethod(radio, MUIM_Notify, MUIA_Radio_Active, 0,
   string, 3, MUIM_Set, MUIA_Disabled, TRUE);

DoMethod(radio, MUIM_Notify, MUIA_Radio_Active, 1,
   string, 3, MUIM_Set, MUIA_Disabled, TRUE);

DoMethod(radio, MUIM_Notify, MUIA_Radio_Active, 2,
   string, 3, MUIM_Set, MUIA_Disabled, FALSE);

\end{verbatim}
\normalsize
\subsection[MUIA\_ExportID]{MUIA\_ExportID -- (V4) [ISG], LONG}

\subsubsection*{FUNCTION}
Objects with a non NULL MUIA\_ExportID export their
contents during MUIM\_Application\_Save and import
them during MUIM\_Application\_Load.

You have to use different ExportIDs for your objects!

\subsubsection*{SEE ALSO}
MUIM\_Application\_Save, MUIM\_Application\_Load

\subsection[MUIA\_FixHeight]{MUIA\_FixHeight -- (V4) [I..], LONG}

\subsubsection*{FUNCTION}
Give your object a fixed pixel height. This tag is
absolutely not needed in a general MUI application
and only present for emergency situations. Please
think twice before using it!

\subsubsection*{EXAMPLE}
\small
\begin{verbatim}
/* create an 8x8 pixel rectangle with FILLPEN */

RectangleObject,
   MUIA_FixWidth  , 8,
   MUIA_FixHeight , 8,
   MUIA_Background, MUII_FILL,
   End;

\end{verbatim}
\normalsize
\subsubsection*{SEE ALSO}
MUIA\_FixWidth, MUIA\_FixWidthTxt, MUIA\_FixHeightTxt

\subsection[MUIA\_FixHeightTxt]{MUIA\_FixHeightTxt -- (V4) [I..], LONG}

\subsubsection*{FUNCTION}
Give your object a fixed pixel height. The height
will match the height of the given string. This tag is
absolutely not needed in a general MUI application
and only present for emergency situations. Please
think twice before using it!

\subsubsection*{EXAMPLE}
\small
\begin{verbatim}
/* create a fixed size rectangle with FILLPEN */

RectangleObject,
   MUIA_FixWidthTxt , "00:00:00",
   MUIA_FixHeightTxt, "\n\n",
   MUIA_Background  , MUII_FILL,
   End;

\end{verbatim}
\normalsize
\subsubsection*{SEE ALSO}
MUIA\_FixHeight, MUIA\_FixWidth, MUIA\_FixWidthTxt

\subsection[MUIA\_FixWidth]{MUIA\_FixWidth -- (V4) [I..], LONG}

\subsubsection*{FUNCTION}
Give your object a fixed pixel width. This tag is
absolutely not needed in a general MUI application
and only present for emergency situations. Please
think twice before using it!

\subsubsection*{EXAMPLE}
\small
\begin{verbatim}
/* create an 8x8 pixel rectangle with FILLPEN */

RectangleObject,
   MUIA_FixWidth  , 8,
   MUIA_FixHeight , 8,
   MUIA_Background, MUII_FILL,
   End;

\end{verbatim}
\normalsize
\subsubsection*{SEE ALSO}
MUIA\_FixHeight, MUIA\_FixWidthTxt, MUIA\_FixHeightTxt

\subsection[MUIA\_FixWidthTxt]{MUIA\_FixWidthTxt -- (V4) [I..], STRPTR}

\subsubsection*{FUNCTION}
Give your object a fixed pixel width. The width
will match the width of the given string. This tag is
absolutely not needed in a general MUI application
and only present for emergency situations. Please
think twice before using it!

\subsubsection*{EXAMPLE}
\small
\begin{verbatim}
/* create a fixed size rectangle with FILLPEN */

RectangleObject,
   MUIA_FixWidthTxt , "00:00:00",
   MUIA_FixHeightTxt, "\n\n",
   MUIA_Background  , MUII_FILL,
   End;

\end{verbatim}
\normalsize
\subsubsection*{SEE ALSO}
MUIA\_FixHeight, MUIA\_FixWidth, MUIA\_FixHeightTxt

\subsection[MUIA\_Font]{MUIA\_Font -- (V4) [I.G], struct TextFont *}

\subsubsection*{SPECIAL INPUTS}
MUIV\_Font\_Inherit\\
MUIV\_Font\_Normal\\
MUIV\_Font\_List\\
MUIV\_Font\_Tiny\\
MUIV\_Font\_Fixed\\
MUIV\_Font\_Title\\
MUIV\_Font\_Big

\subsubsection*{FUNCTION}
Every MUI object can have its own font, just set it with
this tag. Objects without an explicit font setting will
inherit it from their parent group.

You normally won't need to open a font yourself, just
use one of the predefined values to get a font from
the users preferences.

\subsubsection*{EXAMPLE}
\small
\begin{verbatim}
/* since the text contains tabs,           */
/* use the fixed width font for displaying */

msgread = FloattextObject,
   MUIA_Font, MUIV_Font_Fixed,
   ...,
   End;

\end{verbatim}
\normalsize
\subsection[MUIA\_Frame]{MUIA\_Frame -- (V4) [I..], LONG}

\subsubsection*{SPECIAL INPUTS}
MUIV\_Frame\_None\\
MUIV\_Frame\_Button\\
MUIV\_Frame\_ImageButton\\
MUIV\_Frame\_Text\\
MUIV\_Frame\_String\\
MUIV\_Frame\_ReadList\\
MUIV\_Frame\_InputList\\
MUIV\_Frame\_Prop\\
MUIV\_Frame\_Gauge\\
MUIV\_Frame\_Group\\
MUIV\_Frame\_PopUp\\
MUIV\_Frame\_Virtual\\
MUIV\_Frame\_Slider\\
MUIV\_Frame\_Count

\subsubsection*{FUNCTION}
Define a frame for the current object. Since area class
is a superclass for all elements in a window, you can
assign frames to every object you wish.

You don't adjust the style of your frame directly,
instead you only specify a type:

\begin{description}
\item[MUIV\_Frame\_Button] for standard buttons with text in it.
\item[MUIV\_Frame\_ImageButton] for small buttons with images, e.g. the arrows
of a scrollbar.
\item[MUIV\_Frame\_Text] for a text field, e.g. a status line display.
\item[MUIV\_Frame\_String] for a string gadget.
\item[MUIV\_Frame\_ReadList] for a read only list.
\item[MUIV\_Frame\_InputList] for a list that handles input (has a cursor).
\item[MUIV\_Frame\_Prop] for proportional gadgets.
\item[MUIV\_Frame\_Group] for groups.
\end{description}

How the frame is going to look is adjustable via the
preferences program.

Four spacing values belong to each frame that tell
MUI how many pixels should be left free between the
frame and its contents. These spacing values are also
user adjustable as long as you don't override them
with one of the MUIA\_InnerXXXX tags.

\subsubsection*{NOTE}
The first object in a window (MUIA\_Window\_RootObject)
may {\bf not} have a frame. If you need this you will have
to create a dummy group with just one child.

\subsubsection*{EXAMPLE}
\small
\begin{verbatim}
strobj = StringObject,
   MUIA_Frame, MUIV_Frame_String,
   End;

\end{verbatim}
\normalsize
\subsubsection*{SEE ALSO}
MUIA\_InnerLeft, MUIA\_InnerRight, MUIA\_InnerTop,
MUIA\_InnerBottom

\subsection[MUIA\_FramePhantomHoriz]{MUIA\_FramePhantomHoriz -- (V4) [I..], BOOL}

\subsubsection*{FUNCTION}
Setting this to TRUE causes the specified frame to be
a horizontal phantom frame. The frame will not appear
but its vertical components (frame height, inner
top and inner bottom spacing) will be used to calculate
positions and dimensions (horizontal components are
treated as 0).

This is extremely useful for a correct labeling of objects.
You would e.g. label a string gadget by using a text object
with a phantom string frame. Thus, the label text will
be always on the same vertical position as the string
gadget text, no matter what spacing values the user
configured.

\subsubsection*{SEE ALSO}
Label() macros in ''mui.h''.

\subsection[MUIA\_FrameTitle]{MUIA\_FrameTitle -- (V4) [I..], STRPTR}

\subsubsection*{FUNCTION}
This tag identifies a text string that will be displayed
centered in the top line of a frame. This can become
handy if you want to name groups of objects.

You may not use MUIA\_FrameTitle without defining
a MUIA\_Frame.

\subsubsection*{EXAMPLE}
\small
\begin{verbatim}
VGroup,
   MUIA_Frame     , MUIV_Frame_Group,
   MUIA_FrameTitle, "Spacing",
   ...

\end{verbatim}
\normalsize
\subsubsection*{SEE ALSO}
MUIA\_Frame

\subsection[MUIA\_Height]{MUIA\_Height -- (V4) [..G], LONG}

\subsubsection*{FUNCTION}
You can use this to read the current position and
dimension of an object, if you e.g. need it to pop
up some requester below.

Of course, this attribute is only valid when the
parent window of the object is currently open.

\subsubsection*{SEE ALSO}
MUIA\_TopEdge, MUIA\_Width, MUIA\_LeftEdge,
MUIA\_RightEdge, MUIA\_BottomEdge

\subsection[MUIA\_HorizWeight]{MUIA\_HorizWeight -- (V4) [I..], LONG}

\subsubsection*{FUNCTION}
Adjust the horizontal weight of an object. Usually
you can simply use MUIA\_Weight instead of this tag
but in some two-dimensional groups it may become
handy to have different horizontal and vertical
weights.

\subsubsection*{SEE ALSO}
MUIA\_Weight

\subsection[MUIA\_InnerBottom]{MUIA\_InnerBottom -- (V4) [I..], LONG}

\subsubsection*{FUNCTION}
Adjust the space between an object and its frame.
Usually you shouldn't use this tag since you will
override the users preferred default setting.

\subsubsection*{SEE ALSO}
MUIA\_Frame

\subsection[MUIA\_InnerLeft]{MUIA\_InnerLeft -- (V4) [I..], LONG}

\subsubsection*{FUNCTION}
Adjust the space between an object and its frame.
Usually you shouldn't use this tag since you will
override the users preferred default setting.

\subsubsection*{SEE ALSO}
MUIA\_Frame

\subsection[MUIA\_InnerRight]{MUIA\_InnerRight -- (V4) [I..], LONG}

\subsubsection*{FUNCTION}
Adjust the space between an object and its frame.
Usually you shouldn't use this tag since you will
override the users preferred default setting.

\subsubsection*{SEE ALSO}
MUIA\_Frame

\subsection[MUIA\_InnerTop]{MUIA\_InnerTop -- (V4) [I..], LONG}

\subsubsection*{FUNCTION}
Adjust the space between an object and its frame.
Usually you shouldn't use this tag since you will
override the users preferred default setting.

\subsubsection*{SEE ALSO}
MUIA\_Frame

\subsection[MUIA\_InputMode]{MUIA\_InputMode -- (V4) [I..], LONG}

\subsubsection*{SPECIAL INPUTS}
MUIV\_InputMode\_None\\
MUIV\_InputMode\_RelVerify\\
MUIV\_InputMode\_Immediate\\
MUIV\_InputMode\_Toggle

\subsubsection*{FUNCTION}
Adjust the input mode for an object.

MUI has no distinct button class. Instead you can make
every object (even groups) behave like a button by
setting an input mode for them. Several input modes
area available:

\begin{description}
\item[MUIV\_InputMode\_None:] No input, this is not a gadget.
\item[MUIV\_InputMode\_RelVerify:] For buttons and similar stuff.
\item[MUIV\_InputMode\_Immediate:] Used e.g. in a radio button object.
\item[MUIV\_InputMode\_Toggle:] For things like checkmark gadgets.
\end{description}

The input mode setting determines how a user action
will trigger the attributes MUIA\_Selected, MUIA\_Pressed
and MUIA\_Timer. See their documentation for details.

\subsubsection*{EXAMPLE}
\small
\begin{verbatim}
/* A traditional button, just a text object with */
/* a button frame and a relverify input mode:    */

okbutton = TextObject,
   MUIA_Frame        , MUIV_Frame_Button,
   MUIA_InputMode    , MUIV_InputMode_RelVerify,
   MUIA_Text_Contents, "OK",
   ...

\end{verbatim}
\normalsize
\subsubsection*{SEE ALSO}
MUIA\_Selected, MUIA\_Timer, MUIA\_Pressed

\subsection[MUIA\_LeftEdge]{MUIA\_LeftEdge -- (V4) [..G], LONG}

\subsubsection*{FUNCTION}
You can use this to read the current position and
dimension of an object, if you e.g. need it to pop
up some requester below.

Of course, this attribute is only valid when the
parent window of the object is currently open.

\subsubsection*{SEE ALSO}
MUIA\_TopEdge, MUIA\_Width, MUIA\_Height,
MUIA\_RightEdge, MUIA\_BottomEdge

\subsection[MUIA\_Pressed]{MUIA\_Pressed -- (V4) [..G], BOOL}

\subsubsection*{FUNCTION}
Learn if a button is pressed (or released).
The MUIA\_Pressed attribute of a gadget is triggered
by some user action, depending on the input mode:

\begin{itemize}
\item{MUIV\_InputMode\_RelVerify:}
\begin{itemize}
\item{set when lmb is pressed.}
\item{cleared when lmb is released and the mouse is still over the gadget (otherwise it will
be cleared too, but without triggering a
notification event).}
\end{itemize}
\item{MUIV\_InputMode\_Immediate:}
\begin{itemize} \item{undefined, use MUIA\_Selected for this.} \end{itemize}
\item{MUIV\_InputMode\_Toggle:}
\begin{itemize} \item{undefined, use MUIA\_Selected for this.} \end{itemize}
\end{itemize}
   
Waiting for MUIA\_Pressed getting FALSE is the usual
way to react on button gadgets.

\subsubsection*{EXAMPLE}
\small
\begin{verbatim}
DoMethod(btcancel,MUIM_Notify,MUIA_Pressed,FALSE,
   app,2,MUIM_Application_ReturnID,ID_CANCEL);

\end{verbatim}
\normalsize
\subsubsection*{SEE ALSO}
MUIA\_Selected, MUIA\_Timer, MUIA\_ShowSelState, MUIA\_InputMode

\subsection[MUIA\_RightEdge]{MUIA\_RightEdge -- (V4) [..G], LONG}

\subsubsection*{FUNCTION}
You can use this to read the current position and
dimension of an object, if you e.g. need it to pop
up some requester below.

Of course, this attribute is only valid when the
parent window of the object is currently open.

\subsubsection*{SEE ALSO}
MUIA\_TopEdge, MUIA\_Width, MUIA\_Height,
MUIA\_LeftEdge, MUIA\_BottomEdge

\subsection[MUIA\_Selected]{MUIA\_Selected -- (V4) [ISG], BOOL}

\subsubsection*{FUNCTION}
Get and set the selected state of a gadget.
This attribute can be triggered by the user
clicking on the gadget (or using the keyboard),
depending on the input mode:

\begin{itemize}
\item{MUIV\_InputMode\_RelVerify:}
   \begin{itemize}
       \item{set when lmb is pressed.}
       \item{cleared when lmb is released.}
       \item{cleared when the gadget is selected and the
             mouse leaves the gadget box.}
       \item{set when the mouse reenters the gadget box.}
    \end{itemize}

\item{MUIV\_InputMode\_Immediate:}
\begin{itemize} \item{set when lmb is pressed.} \end{itemize}

\item{MUIV\_InputMode\_Toggle:}
\begin{itemize} \item{toggled when lmb is pressed.} \end{itemize}
\end{itemize}

Of course you may set this attribute yourself, e.g.
to adjust the state of a checkmark gadget.

A selected gadget will display its border reverse
and get the configured MUII\_SelectedBack background.
This can be avoided using the MUIA\_ShowSelState tag.

\subsubsection*{SEE ALSO}
MUIA\_Pressed, MUIA\_Timer, MUIA\_ShowSelState, MUIA\_InputMode

\subsection[MUIA\_ShowMe]{MUIA\_ShowMe -- (V4) [ISG], BOOL}

\subsubsection*{FUNCTION}
Objects with this attribute set are not displayed. You can
set MUIA\_ShowMe at any time, causing objects to appear and
to disappear immediately. A new layout is calculated whenever
some objects are shown or hidden. When necessary, MUI will
resize the parent window to make place for the new objects.

\subsubsection*{NOTE}
Currently, MUI does a complete window refresh after
showing/hiding objects. This behaviour might get improved
in the future.

\subsection[MUIA\_ShowSelState]{MUIA\_ShowSelState -- (V4) [I..], BOOL}

\subsubsection*{FUNCTION}
Normally a gadget will reverse its frame and
display the configured MUII\_SelectetBack background
pattern in its selected state. For some objects
(e.g. checkmarks) this is not recommended and
can be supressed by setting MUIA\_ShowSelState
to FALSE.

\subsubsection*{SEE ALSO}
MUIA\_Selected

\subsection[MUIA\_Timer]{MUIA\_Timer -- (V4) [..G], LONG}

\subsubsection*{FUNCTION}
MUIA\_Timer gets triggered when a relverify button is
pressed and (after a little delay) increases every
INTUITICK as long as the mouse remains over the gadget.

This makes it possible to have buttons repeatedly
cause some actions, just like the arrow gadgets of
a scrollbar.

\subsubsection*{EXAMPLE}
\small
\begin{verbatim}
DoMethod(btmore,MUIM_Notify,MUIA_Timer,MUIV_EveryTime,
   app,2,MUIM_Application_ReturnID,ID_MORE);

DoMethod(btless,MUIM_Notify,MUIA_Timer,MUIV_EveryTime,
   app,2,MUIM_Application_ReturnID,ID_LESS);

\end{verbatim}
\normalsize
\subsubsection*{SEE ALSO}
MUIA\_Pressed, MUIA\_Selected

\subsection[MUIA\_TopEdge]{MUIA\_TopEdge -- (V4) [..G], LONG}

\subsubsection*{FUNCTION}
You can use this to read the current position and
dimension of an object, if you e.g. need it to pop
up some requester below.

Of course, this attribute is only valid when the
parent window of the object is currently open.

\subsubsection*{SEE ALSO}
MUIA\_LeftEdge, MUIA\_Width, MUIA\_Height,
MUIA\_RightEdge, MUIA\_BottomEdge

\subsection[MUIA\_VertWeight]{MUIA\_VertWeight -- (V4) [I..], LONG}

\subsubsection*{FUNCTION}
Adjust the vertical weight of an object. Usually
you can simply use MUIA\_Weight instead of this tag
but in some two-dimensional groups it may become
handy to have different horizontal and vertical
weights.

\subsubsection*{SEE ALSO}
MUIA\_Weight

\subsection[MUIA\_Weight]{MUIA\_Weight -- (V4) [I..], LONG}

\subsubsection*{FUNCTION}
This tag is a shorthand for MUIA\_HorizWeight and
MUIA\_VertHeight, it sets both weights at once.

The weight of an object determines how much room it
will get during the layout process. Imagine you have
a 100 pixel wide horizontal group with two string
gadgets. Usually, each gadget will get half of the
room and be 50 pixels wide. If you feel the left
gadget is more important and should be bigger,
you can give it a weight of 200 (and 100 for
the right gadget). Because the left gadget is
twice as ''heavy'' as the right gadget, it will
become twice as big (about 66 pixel) as the
right one (34 pixel).

Of course giving weights only makes sense if the
object is resizable. A MUIA\_VertWeight for a
(always fixed height) string gadget is useless. \\
An object with a weight of 0 will always stay
at its minimum size.\\
By default, all objects have a weight of 100.

\subsubsection*{EXAMPLE}
\small
\begin{verbatim}
HGroup,
   StringGadget, MUIA_Weight,  50, End,
   StringGadget, MUIA_Weight, 100, End,
   StringGadget, MUIA_Weight, 200, End,
   End;

\end{verbatim}
\normalsize
\subsubsection*{SEE ALSO}
MUIA\_HorizWeight, MUIA\_VertWeight

\subsection[MUIA\_Width]{MUIA\_Width -- (V4) [..G], LONG}

\subsubsection*{FUNCTION}
You can use this to read the current position and
dimension of an object, if you e.g. need it to pop
up some requester below.

Of course, this attribute is only valid when the
parent window of the object is currently open.

\subsubsection*{SEE ALSO}
MUIA\_TopEdge, MUIA\_LeftEdge, MUIA\_Height,
MUIA\_RightEdge, MUIA\_BottomEdge

\subsection[MUIA\_Window]{MUIA\_Window -- (V4) [..G], struct Window *}

\subsubsection*{FUNCTION}
This attribute can be used to get a pointer to the
intuition window structure of the parent window
ot the object. This pointer could e.g. be used
in calls to asl.library.

The result is only valid when the window is opened.

\subsubsection*{SEE ALSO}
MUIA\_Window\_Window

\subsection[MUIA\_WindowObject]{MUIA\_WindowObject -- (V4) [..G], Object *}

\subsubsection*{FUNCTION}
You can obtain a pointer to the window object
that some gadget belongs to by using this attribute.
Useful mainly within callback hooks if you do not want
to deal with global variables.

\subsubsection*{SEE ALSO}
MUIA\_ApplicationObject


